Mit dem generischen Auftragsimport können Kunden Ihre Bestellung in einer XML übermitteln, die per Skript in die ingenious Datenbank eingelesen und als Auftrag angelegt wird.

Die Einstellungen für den Dokumentenimport werden am Kontaktdatensatz des Kunden gespeichert.

Für jeden Kunden können die Dateiablage und die XML-Struktur individuell definiert werden.

Konfiguration des XML Dokumentenimport für einen Kontakt

Funktionen

Für die Einstellungen des XML Dokumentenimports stehen die folgenden Funktionen über die Icon-Leiste zur Verfügung:

	Fügt einen Artikel mit seiner Vorkonfiguration in die XML Struktur ein.
	Fügt einen neuen Knoten hinzu.
	Löscht den markierten Knoten. (Knoten, die für die Struktur mindestens erforderlich sind, können nicht entfernt werden.
	Exportiert die XML Vorlage zur Weitergabe an den Kunden. Es öffnet der Windows Speichern Dialog, in dem Ablageort gewählt und der Dateiname vergeben werden kann.

Dateiablage

FTP-Server

XML-Einstellungen

In den XML-Einstellungen wird die Struktur der XML-Datei vorgegeben.

Für jede neue Kunden-Konfiguration wird die Basis-Struktur geladen, die aus dem Header und der Item-List besteht.

Für jeden Knoten wird der Name, die Verknüpfung zum Datenbankfeld oder Stücklistenvariable, eine optionale individuelle Beschreibung, ein eventueller vorbelegter Standardwert und das Kennzeichen für ein Pflichtfeld angegeben.

Aufbau des Headers

Im Header werden die Kopfdaten des Auftragsdokuments angegeben.

Standard-Knoten

Die Standard-Knoten stellen die Minimalkonfiguration der XML-Struktur dar.

Diese müssen in der vom Kunden angelieferten XML zwingend enthalten sein.

Standard-Knoten können nicht gelöscht werden.

Weitere Knoten

Über den Button  können dem Header weitere Konten hinzugefügt werden.

Mit dem Knoten <DELIVERY_DATE> mit der Verknüpfung zu einem Projektdatumsfeld, z.B. DB.date_9 kann zum Beispiel der Kunde einen Wunschliefertermin übermitteln.

Aufbau der Positionsliste

In der Positionsliste <ITEM_LIST> werden alle Positionen eines Auftrags aufgelistet.

Für jede Position wird ein Knoten <ITEM> geschrieben, der die folgenden Standard-Elemente enthält:

Für jeden zu bestellenden Artikel müssen alle Eigenschaften definiert werden, mit denen er eindeutig identifiziert bzw. produziert werden kann.

Für Produkte, die aus mehreren Einzelteilen gerfertigt werden, müssen auch Angaben zur gewünschten Ausführung gemacht werden.
In den so genannten Stücklisten sind alle Varianten eines komplexen Produkts definiert.
Für jede Eigenschaft wird eine Variable festgelegt, die unterschiedliche Werte enthalten kann.

In der XML-Struktur müssen für einen solchen Artikel alle notwendigen Variablen aufgeführt werden.

Stücklistenkonfiguration

Über den Button  kann über die Artikelsuche die gewünschte Stückliste geladen werden.

Es öffnet die Checkliste, in der bestimmt wird, welche Optionen in der XML enthalten sein sollen (1. Checkbox) und welche Optionen zwingend gefüllt werden müssen (2. Checkbox).

Außerdem kann bereits eine Standardkonfiguration vorgenommen werden.

Sind für einzelne Optionen in der vom Kunden übermittelten XML keine Werte eingetragen, so wird der Standardwert angenommen (z.B. der Kunde bestellt immer eine bestimmte Profilart oder Farbe).

Konfiguration einer Stückliste für den XML Auftragsimport eines Kunden

Alle Parameter einer Stückliste werden entsprechend der vorangegangenen Konfiguration in die XML-Struktur geladen.

Anschließend können die Details der einzelnen Knoten weiter bearbeitet werden.

So können z.B. in der Beschreibung die möglichen Werte eines Parameters zur Info für den Kunden angegeben werden.

Artikel-Knoten einer Stückliste

Die Vorkonfiguration einer Stückliste kann auch bereits in den Artikeldaten erfolgen und steht dann beim Hinzufügen des Artikels für alle Kundenkonfigurationen zur Verfügung.

vgl. Quellcode Ansicht und Aufmass

Übergabe der XML

Ist die XML-Struktur fertig definiert, so kann über den Button  eine Vorlage für den Kunden exportiert werden.

Mit Hilfe dieser Vorlage kann der Kunde für seine Software einen Export seiner Bestellungen programmieren (lassen).

<?xml version="1.0" encoding="utf-8"?>
<DOCUMENT mandatory="true">
    <HEADER mandatory="true">
        <CUSTOMER mandatory="true" description="Kurzbezeichnung des Kunden">Mustermann GmbH</CUSTOMER>
        <NAME mandatory="true" description="Name des Dokuments">Auftragsbestätigung</NAME>
        <NUMBER description="Projektkommission oder eigene Bestellnummer"></NUMBER>
        <DELIVERY_DATE description="Wunschliefertermin"></DELIVERY_DATE>
    </HEADER>
    <ITEM_LIST mandatory="true">
        <ITEM>
            <ITEM-ID mandatory="true" description="Artikelnummer"></ITEM-ID>
            <ITEM-NAME mandatory="true" description="Artikelmatchcode"></ITEM-NAME>
            <QUANTITY mandatory="true">1</QUANTITY>
            <X>100</X>
            <Y>100</Y>
            <Z>100</Z>
        </ITEM>
        <ITEM>
            <ITEM-ID mandatory="true">R1</ITEM-ID>
            <ITEM-NAME mandatory="true">Rollladenpanzer</ITEM-NAME>
            <QUANTITY mandatory="true">1</QUANTITY>
            <X mandatory="true">100</X>
            <Y mandatory="true">100</Y>
            <info></info>
            <vPType mandatory="true">ALU 36 mm</vPType>
            <vPoLS>0</vPoLS>
            <vPColor mandatory="true" description="Farbe: PVC: weiß, beige, braun, grau, tannengrün; ALU: weiß, beige, braun, grau, azurblau, moosgrün, tannengrün, RAL">braun</vPColor>
            <vPRal></vPRal>
            <vPAtt mandatory="true">Mini-Aufhängefeder</vPAtt>
            <vEType>ALU-Endleiste</vEType>
            <vEDiffColor>False</vEDiffColor>
            <vEColor>braun</vEColor>
            <vERal></vERal>
            <vEStpType>27mm</vEStpType>
            <vEStpFarbe>braun</vEStpFarbe>
            <vEBohren>True</vEBohren>
        </ITEM>
    </ITEM_LIST>
</DOCUMENT>

Import der Auftragsdaten

Der Import der Auftragsdaten selbst wird zeitgesteuert durch den Scheduler ausgeführt.

Dafür ist ein Skript für das Modul Scheduler mit folgendem Aufruf anzulegen:

public void XML_Import(out bool bError, out string sResult, out string sDescription)
{
    bError = false;
    sResult = "";
    sDescription = "";
    ingenious.net.Moduls.ProjectXmlImport.Import.Start(out bError, out sResult, out sDescription);
}

Im Scheduler wird dann in der Allgemeinen Aufgabenplanung dieses Skript als auszuführende Methode ausgewählt.